package cn.tedu.suppermemory.service;

import cn.tedu.suppermemory.pojo.dto.PermissionAddNewDTO;
import cn.tedu.suppermemory.pojo.dto.PermissionUpdateDTO;
import cn.tedu.suppermemory.pojo.entity.Permission;
import cn.tedu.suppermemory.pojo.vo.PermissionListItemVO;
import cn.tedu.suppermemory.pojo.vo.PermissionStandardVO;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * 处理权限数据的业务接口
 *
 * @author why
 * @version 0.0.1
 */
@Transactional
public interface IPermissionService {

    /**
     * 添加权限
     *
     * @param permissionAddNewDTO 权限数据
     */
    void addNew(PermissionAddNewDTO permissionAddNewDTO);

    /**
     * 删除权限
     *
     * @param id 权限id
     */
    void delete(Long id);

    /**
     * 根据id修改权限数据
     *
     * @param id     被修改的权限的id
     * @param permissionUpdateDTO  封装了新基本数据的对象
     */
    void updateInfoById(Long id, PermissionUpdateDTO permissionUpdateDTO);

    /**
     * 根据权限id查询权限数据
     *
     * @param id 权限的id
     * @return 匹配的权限详情，如果没有匹配的数据，将抛出异常
     */
    PermissionStandardVO getStandardById(Long id);

    /**
     * 查询权限列表数据
     *
     * @return  List<PermissionListItemVO> 权限列表
     */
    List<PermissionListItemVO> list();

}
